home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / giochi / amigainf.lha / inform / general-notes.txt < prev    next >
Text File  |  1995-08-02  |  4KB  |  106 lines
  1.  
  2. Manuals
  3. =======
  4. For the first time in two years, an attempt has been made to rewrite the
  5. documentation altogether (and "properly this time"), though some passages
  6. from the old manual do remain.  There are now two Inform manuals:
  7.  
  8.   The Inform Designer's Manual  (106 pages of A4)
  9.   The Inform Technical Manual  (22 pages of A4)
  10.  
  11. and only the former will be of interest to most users.  The manuals are
  12. given in TeX, a text-markup-language used by mathematicians and scientists
  13. which is just about readable as ASCII (after a fashion); there will shortly
  14. be plain text and postscript editions too.
  15.  
  16. The Designer's Manual has some 31 exercises with full answers (mainly for
  17. extended examples: how to implement difficult puzzles), proper documentation
  18. of exactly what attributes do, advice on error messages, a long index (about
  19. 800 entries), a specification of the language, a lengthy tutorial (the first
  20. half is mainly tutorial in style) and details of all the new features.  In
  21. my view it's hugely better than its predecessor.  The Technical Manual is,
  22. as it claims, technical.
  23.  
  24. The author's paper,
  25.  
  26.   The Specification of the Z-Machine  (44 pages of A4)
  27.  
  28. (which also documents the assembler at the bottom of Inform) has also been
  29. re-posted in TeX form, in an updated edition.  It has been tidied up somewhat
  30. and a few mistakes in the previous edition (none of much consequence) have
  31. been corrected; the very last opcode in Version 6, recently discovered by
  32. Mark Howell, has been added.  Inform 5.3 changed the opcode names slightly
  33. to bring them in line with a standard set of names agreed between Mark and
  34. myself, and this paper uses them.  (Thus Mark's disassembler "txd" now uses
  35. exactly the same names as the Inform assembler.)
  36.  
  37. Balances
  38. ========
  39. The source code to Release 2 of this slight but hopefully amusing game is
  40. now available (it needs I5.4 to compile).  The game itself has been
  41. re-posted also, and has many small bugs (none serious) fixed.  The author is
  42. grateful to the many who have written to make complaints and suggestions.
  43. The "spell-casting" code is, incidentally, easily transplantable.
  44.  
  45. Toyshop
  46. =======
  47. A number of new toys have arrived on the shop floor: a matchbook of five
  48. matches and a box of eight candles (to demonstrate imitation and real plural
  49. objects, respectively), a blackboard you can write any sentence on and a
  50. pair of gloves which can separate into a left and right glove on request.
  51.  
  52. Advent
  53. ======
  54. Is hardly changed at all, except in being flagged as Release 2 to distinguish
  55. it from the incorrectly-compiled version posted earlier.
  56.  
  57.  
  58.  
  59. Files on Inform
  60. ===============
  61.  
  62. The Inform home directory is  if-archive/infocom/compilers/inform at
  63. the anonymous FTP archive ftp.gmd.de.
  64.  
  65. The directory "source" contains ANSI C source for the compiler, divided
  66. into a number of files.  Note that the header file no longer contains the
  67. ever-growing modification history, which has been moved to the Technical
  68. Manual, which porters may find useful.  There is also a single tar file
  69. containing all the source files.
  70.  
  71. The directory "examples" contains Inform source code for Shell, Hello
  72. Cruel World, Toyshop, Advent and Balances.  Each is a single file named
  73. as whatever.inf.
  74.  
  75. The directory "library" contains the three files which make up the Library,
  76. i.e.,
  77.  
  78.     parser.h    verblib.h     grammar.h
  79.  
  80. The directory "executables" is provided for executable copies.  The
  81. Acorn Archimedes version is called
  82.  
  83.     archimedes_5.4
  84.  
  85. and I would ask porters to use a similar notation - i.e., to use a file
  86. name to indicate the machine, include the number 5.4 and indicate the
  87. compression format if there is one.  (This one is a single executable file.)
  88.  
  89. The directory "manuals" contains TeX source of the documents available:
  90.  
  91.     designers_manual.tex
  92.     technical_manual.tex
  93.     specification.tex
  94.  
  95. and will hopefully soon contain .ps (PostScript) and .plain_text files.
  96.  
  97. In addition there are a number of actual games, which have file-names
  98. ending in ",z3" or ".z5".  These must be downloaded in binary mode,
  99. and can only be run with the aid of an interpreter for your machine:
  100. see the directory  if-archive/infocom/interpreters  to find one.
  101.  
  102.  
  103. Graham Nelson
  104. Oxford University
  105. October 2nd, 1994
  106.